home *** CD-ROM | disk | FTP | other *** search
/ Super PC 33 / Super PC 33 (Shareware).iso / spc / inter / wsarch16 / wsarch10.txt next >
Encoding:
Text File  |  1995-11-10  |  12.5 KB  |  283 lines
  1. This is the first non beta version (V1.0) of a windows based archie client.
  2. There are two changes from the previous release (V0.8)
  3.  
  4. The changes are:
  5.  
  6. 1) If the ftp fails, more detailed error messages are displayed. 
  7.  
  8. 2) A bug that caused directory expansion to fail sometimes has been fixed.
  9.  
  10. If you have problems
  11. ====================
  12.  
  13. Do please tell me of any problems via email (david.woakes@dial.pipex.com).
  14. Please do not send queries about WSARCHIE to any other email addresses.
  15.  
  16. I'm currently working full time so I have less time to spend on this than
  17. previously. As a result I may not get back to you straight away, but I will 
  18. do my best.
  19.  
  20. David Woakes (david.woakes@dial.pipex.com)
  21.  
  22. Credits:
  23.  
  24. This archie client is based upon the archie client that is included in the
  25. Prospero V5.2a release.
  26.  
  27. It was written by Clifford Neuman with changes by Brendan Kehoe
  28. and George Ferguson.
  29.  
  30. If you want to know more about Prospero send an email message to 
  31. info-prospero@isi.edu.  Do not send questions about WSARCHIE to
  32. this address, send them to david.woakes@dial.pipex.com, PLEASE.
  33.  
  34. Keep an eye on my WWW home page for latest releases:
  35.  
  36. http://dspace.dial.pipex.com/town/square/cc83/
  37.  
  38.  
  39. Installation.
  40. =============
  41.  
  42. This instructions assume that you have some form of WINSOCK installed and
  43. working.
  44.  
  45. 1. Unzip wsarchie.zip in a directory by itself. There should be four files
  46. altogether:
  47.  
  48. wsarchie.exe    - this is the program itself.
  49. wsarchie.hlp    - this is wsarchie's windows help file. This should probably
  50.                   reside in the same directory as wsarchie.exe.
  51. wsarchie.ini    - contains the list of archie servers, and user preference
  52.                   settings. This file can be left in wsarchie's working
  53.                   directory or placed in c:\windows.
  54. wsarch10.txt    - this file
  55.  
  56. 2. Use the FTP Setup command in the Options menu to setup the command line
  57. for the FTP client. This is a non essential step, but is useful. Note that
  58. the FTP command is the full path and name of the FTP program in use. The
  59. directory is the directory where you want files to be downloaded to. If the
  60. ftp command doesn't work, check that you have got a hold of a recent copy.
  61. See below for details.
  62.  
  63. That's it. As long as wsarchie.ini is in wsarchie.exe's working directory
  64. everything should go swimmingly. You can add an icon in a program manager
  65. group in the usual fashion (ie drag wsarchie.exe from the file manager to
  66. the desired group, or use {file, new} from the program manager menu).
  67. The icon is derived from the Winsock icon.
  68.  
  69. To use, enter your search term in the "Search for" field, and then press
  70. return, or select the Search button. If things go successfully then you
  71. should see the title bar change informing you of packets being recieved.
  72. When complete the results will be displayed in the host, directories and
  73. files list boxes. Full details of the selected file will be displayed below.
  74. Note some archie servers seem to give fewer details than others.
  75.  
  76. To change the default Archie server use the Option Menu command User
  77. Preferences. A dialog will be displayed, currently this allows default
  78. archie client and default search type to be set.
  79.  
  80. The domain box can be used to limit the sites that the Archie Server will
  81. consider during it's search.
  82.  
  83. The following is the list of known problems with wsarchie and how they can be
  84. solved (or not).
  85.  
  86. 1.  WS_FTP (16 or 32 bit versions) fail to execute.
  87.  
  88. Get the latest version from either
  89.  
  90. ftp.usma.edu:/pub/msdos or somewhere on 147.51.200.18 (it is fairly obvious
  91. if you try).
  92.  
  93. Also check the content of the FTP dialog box.  The command line should
  94. contain the full command line including the directory that WS_FTP.EXE
  95. or WS_FTP32.EXE reside. The Directory box should contain the directory
  96. you want files down loaded to. Read the help on setting this up for full
  97. details.
  98.  
  99. 2.  There is no response from the server, even though you can telnet to it.
  100.  
  101. This is usually caused by a firewall on your site blocking the incoming packets 
  102. because they are UDP packets.  You will need to talk to your network supervisor. 
  103. Wsarchie (Version 0.2+) uses a non privileged port number above 2050 (the actual 
  104. number may vary), so there shouldn't be problems with letting them in.  Some 
  105. administrators take a different view and refuse to let these packets in.  There is 
  106. nothing I can do if you cannot get the network administrator to change there 
  107. philosophy.  Try the latest version of wsarchie available from 
  108. ftp.demon.co.uk:/pub/ibmpc/winsock/apps/wsarchie.
  109.  
  110. 3.  You get the message "WINSOCK ERROR: NO_DATA: No entry found".
  111.  
  112. This means that the name server lookup failed.  Try using telnet to connect to the 
  113. archie client.  If this succeeds from the same machine then there is a problem 
  114. with name resolution.  If you are probably using Chameleon's winsock, try reducing 
  115. your list of name servers to one or check whether the latest version fixes this.
  116.  
  117.  
  118. 4.  With PC-NFS V5.1 you will often get the error WINSOCK ERROR: EMSGSIZE.
  119.  
  120. I believe this is caused by an underlying restriction in the winsock stack. There 
  121. is nothing that I can do about this.
  122.  
  123. 5.  With Novell Winsock, an empty error dialog is displayed when a search is 
  124. started.
  125.  
  126. Hopefully this version should at least display an error number here.
  127.  
  128. 6. With Novell Winsock, searches fail with the error ENOBUFS.
  129.  
  130. Check your net.cfg file.  If there are lines in it like:
  131.  
  132. tcp_sockets 32
  133. udp_sockets 8
  134. raw_sockets 1
  135.  
  136. then taking them out might fix the problem, but will probably restrict the winsock 
  137. capabilities.  I wouldnÆt really suggest that you play with these settings unless 
  138. you are fairly expert on Novell.
  139.  
  140. WSARCHIE may be distributed freely on a non profit basis subject to the
  141. licensing agreement from USC below.  If you like the software then feel 
  142. free to send me (David Woakes) 5 Pounds Sterling (or the equivalent in 
  143. your local currency).  This is however optional, and I am not going to 
  144. chase anyone who hasn't paid up.
  145.  
  146. The address to send your donation to is:
  147.  
  148. David Woakes
  149. 88 Spottiswoode St
  150. Edinburgh
  151. EH9 1DJ
  152.  
  153. I attach a copy of the latest licensing agreement from the University of
  154. Southern California:
  155.  
  156. /* 
  157.  *  Copyright (c) 1991-1994 by the University of Southern California
  158.  *  All rights reserved.
  159.  *
  160.  *  PROSPERO(TM) LICENSE AGREEMENT
  161.  *
  162.  * 1. COPYRIGHT.  The Prospero software is owned by the University of
  163.  *    Southern California and is protected by the United States copyright 
  164.  *    laws and international treaty provisions.  Other copyrights may
  165.  *    apply to parts of the Prospero distribution and are so noted when
  166.  *    known to be applicable.
  167.  * 
  168.  * 2. DISCLAIMER OF WARRANTY.  THIS SOFTWARE IS PROVIDED "AS IS".  The
  169.  *    University of Southern California MAKES NO REPRESENTATIONS OR
  170.  *    WARRANTIES, EXPRESS OR IMPLIED.  By way of example, but not
  171.  *    limitation, the University of Southern California MAKES NO
  172.  *    REPRESENTATIONS OR WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY
  173.  *    PARTICULAR PURPOSE OR THAT THE USE OF THE LICENSED SOFTWARE
  174.  *    COMPONENTS OR DOCUMENTATION WILL NOT INFRINGE ANY PATENTS,
  175.  *    COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.  The University of Southern
  176.  *    California shall not be held liable for any liability nor for any
  177.  *    direct, indirect, or consequential damages with respect to any
  178.  *    claim by the user or distributor of the Prospero software or any
  179.  *    third party on account of or arising from this Agreement or the use
  180.  *    or distribution of the Prospero software. 
  181.  * 
  182.  * 3. GRANT OF LICENSE.
  183.  * 
  184.  *  a) Permission to use, copy, modify, and distribute this software and
  185.  *     its documentation in source and binary forms is hereby granted,
  186.  *     provided that:
  187.  * 
  188.  *       i) the use, copying, or distribution is not done for direct
  189.  *          commercial advantage;
  190.  * 
  191.  *      ii) any distribution of the software is on the same terms as in
  192.  *          this Prospero License Agreement, and each copy contains the
  193.  *          copyright notices and the license agreement that appear in
  194.  *          this software and supporting documentation; and  
  195.  * 
  196.  *     iii) any documentation or other materials related to such
  197.  *          distribution or use acknowledge that the software was developed
  198.  *          by the University of Southern California.  
  199.  * 
  200.  *  b) Permission to copy, modify, and distribute this software and its
  201.  *     documentation in source and binary forms AS PART OF ANOTHER
  202.  *     PRODUCT for commercial advantage is hereby granted, provided that:
  203.  * 
  204.  *       i) notice is provided to the University of Southern California
  205.  *          describing the use of Prospero in the product;    
  206.  * 
  207.  *      ii) any distribution of the software is on the same terms as in
  208.  *          this Prospero License Agreement, and those terms apply also to
  209.  *          the distribution and use of that part of the product derived
  210.  *          from the Prospero distribution (it is acceptable to
  211.  *          impose additional restrictions on other parts of the product), 
  212.  *          and each copy contains the copyright notices and the license
  213.  *          agreement that appear in this software and supporting
  214.  *          documentation; 
  215.  * 
  216.  *     iii) any documentation or other materials related to such
  217.  *          distribution or use acknowledge that the software was developed
  218.  *          by the University of Southern California; and
  219.  * 
  220.  *      iv) one of the following three conditions is met:
  221.  * 
  222.  *          a. The product so distributed has been developed
  223.  *             independently and it incorporates only files and related
  224.  *             functions (e.g. allocators) from the Prospero distribution
  225.  *             needed to providing compatibility with the Prospero
  226.  *             distribution; or  
  227.  * 
  228.  *          b. the product so distributed has been developed independently
  229.  *             and the parts of the Prospero distribution included
  230.  *             constitute less than 25% of the product, and the total annual
  231.  *             sales of products incorporating Prospero does not exceed
  232.  *             $100,000 (U.S. Dollars); or
  233.  * 
  234.  *          c. parties to which the product is sold or distributed are
  235.  *             allowed to use or distribute the product in source and binary
  236.  *             forms without fee if the party's use or distribution of the
  237.  *             product is not for direct commercial advantage. 
  238.  * 
  239.  *  c) Permission to use this software to provide a service for a fee is
  240.  *     granted provided that notice is provided to the University of
  241.  *     Southern California describing the nature of the service and
  242.  *     provided that the total annual revenues for the service provided
  243.  *     using Prospero does not exceed $250,000 (U.S. dollars).
  244.  * 
  245.  *  d) Any use, copying, modification, or distribution other than as
  246.  *     provided for above requires an additional license from the
  247.  *     University of Southern California.  The University of Southern
  248.  *     California is prepared to license this software for such use on
  249.  *     reasonable terms.  
  250.  * 
  251.  * 4. OTHER RESTRICTIONS.  Nothing in this Agreement shall be construed
  252.  *    as conferring rights to use in advertising, publicity, or
  253.  *    otherwise, the name of the University of Southern California, or
  254.  *    any trademark thereof. 
  255.  * 
  256.  *   This agreement shall be construed, interpreted, and applied in
  257.  *   accordance with the laws of the State of California, United States of
  258.  *   America.  If any part of this Agreement is held illegal or
  259.  *   unenforceable, the remaining portions shall not be affected.
  260.  * 
  261.  *   Any notice required under this agreement shall be sent to the Prospero
  262.  *   Project; Information Sciences Institute; University of Southern
  263.  *   California; 4676 Admiralty Way; Marina del Rey, California 90292-6695
  264.  *   USA. Any questions concerning the Prospero distribution should be
  265.  *   directed to info-prospero@isi.edu.
  266.  * 
  267.  *   Prospero was originally written by Clifford Neuman (bcn@isi.edu) while
  268.  *   a graduate student at the University of Washington, and subsequently at
  269.  *   the Information Sciences Institute of the University of Southern
  270.  *   California.  Contributors include Steven Seger Augart (swa@isi.edu),
  271.  *   Santosh Rao (srao@isi.edu), and other individuals identified in the
  272.  *   software distribution and accompanying documentation.
  273.  * 
  274.  *   Prospero, the Prospero Directory Service, the Prospero File System, 
  275.  *   and the Prospero Resource Manager are trademarks of the 
  276.  *   University of Southern California. 
  277.  * 
  278.  */
  279.  
  280. Good Luck
  281.  
  282. David Woakes (david.woakes@dial.pipex.com).
  283.